Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 16 - Storage Objects / Storage Objects Reference

Storage Objects Routines / Managing Storage Objects

Q3Storage_SetData

You can use the Q3Storage_SetData function to set the data stored in a storage object.

TQ3Status Q3Storage_SetData (
TQ3StorageObject storage, 
unsigned long offset, 
unsigned long dataSize, 
const unsigned char *data, 
unsigned long *sizeWritten);

storage

A storage object.

offset

An offset into the specified storage object.

dataSize

The number of bytes of data from the specified buffer to be written to the specified storage object.

data

On entry, a pointer to a buffer that contains the data you want to be written to the specified storage object.

sizeWritten

On exit, the number of bytes of data written to the specified storage object.

DESCRIPTION

The Q3Storage_SetData function sets the data associated with the storage object specified by the storage parameter to the data specified by the dataSize and data parameters. The data is written to the storage object starting at the byte offset specified by the offset parameter. Q3Storage_SetData returns, in the sizeWritten parameter, the number of bytes of data written to the storage object. If the value returned in the sizeWritten parameter is less than the number of bytes requested in the dataSize parameter, then the end of the storage object's private data occurs at the distance offset + sizeWritten from the beginning of the private data.